Contents
LC3 Help Contents

The List Collection v3.0 (LC3) is a set of component controls and objects designed to solve the general problem of storing, manipulating, and displaying lists of data.  The forte of LC3 lies in its ability to handle large amounts of data quickly and to provide highly configurable mechanisms for displaying that data.

The List and Item OLE Automation Objects:

The List and Item Objects form the basis of the List Collection and provide a locus of interaction between the other controls.  A List is built by adding Items to it.  Lists behave much like an array with a zero based index.  Each Item in a List has many properties available for data storage and display.  List are displayed using the List Collection OLE Controls.  Lists are used by the other List Collection OLE Objects to store the results of an operation and also as input parameters for an operation.

	lcItemObj Object :	The List Collection Item Object.  Many properties for data storage and display.
	lcListObj Object :	The List Collection List Object.  Maintains a list of Items like an array.
The List Collection OLE Controls:

The List Collection OLE Controls serve to display data stored in the List and Item Objects.  All of the Controls have a .List property which gives you direct access to the underlying List for that control.  You may also access all of the properties and methods in that List and, thereby, those of the Item Objects in that List as well.  The List is displayed according to the particular layout of a control (Item, List, Tree, Group, etc.).  Most of these controls provide facilities for default Item display (of parent items, for example), special effects, and others.

	lcQuick Control :	A simplified version of the lcTree Control.  A good place to get started quickly without being overwhelmed by too many options.
	lcTree Control :	Expand/Collapse Tree Control
	lcGroup Control :	Displays a sublist of Children at a time.  Can be arranged horizontally or vertically, with ItemWrap.
	lcTabRas Control :	Also displays only children.  Allows complete control over Item position and size.
View All Control Properties and Methods

Other List Collection Components:

These List Collection OLE Automation Objects and Controls perform specialized processing tasks using the List and Item Objects.

OLE Automation Objects:

	lcFilerObj Object :	Performs File/Dir searching and places results in a List.  Each Item in the List contains information on the File/Dir entry.
	lcParseObj Object :	Performs token parsing on a string.  A List of Keywords and a List of Symbols is available for modification in order to recognize certain tokens.  The resulting tokens are placed in a List.  Each Item in the List is set with a particular Text, TokenType, and TokenIndex for that token.
OLE Controls:

	lcItem Control :	Display a single Item.  Much like an enhanced label control
	lcPPG Control :	Provides run-time Property Page access for Item Objects
Overviews:

Topics on using certain features of the List Collection.

Control Properties :	A discussion of properties which are common to many of the List Collection Controls.
Optimizations :	Techniques for increasing the performance of the List Collection Controls.
Hierarchies :	How to create hierarchies and extract hierarchical information using the lcItemObj and lcListObj Objects..
Item Borders :	Information on using the Border properties of the lcItemObj Object.
Item Images :	Information on using the Image properties of the lcItemObj Object.
Item Styles :	Information on using the Style properties of the lcItemObj Object.
Formatted Text :	Information on using embedded formatting codes using the lcItemObj's FmtText property.
Constants :	Constants used with the List Collection Controls and Objects
Contacting RA-Ware Technologies:

Internet :	www.rawtech.com
CompuServe :	GO RAWTECH
Email :	Andre@rawtech.com
Phone :	703-518-4480
Fax :	703-519-0030


Control Properties

This section describes the usage of properties common accross most of the LC3 OCX controls.

Multiple Selection:

Multiple selection of Items in a List is controlled through the use of the Ctrl and Shift keys. Pressing down the Ctrl key while selecting Items, will select each Item clicked on and maintain any previous selection.  The Ctrl key is used to select multiple, discontinuous Items.  The Shift key is used to select multiple, continuous Items.  If the Shift key is pressed down while selecting Items, each Item clicked on gets selected as well as each Item in between, and discards any previous selection.  This is used to select a single range of Items.  Using both the Ctrl and Shift keys, you can select multiple, dicontinuous ranges of Items.

Applies To:

lcQuick	lcTree	lcGroup	lcTabRas

View-Specific Item Properties:

In addition to the ton of Item properties available in the lcItemObj object, there are several additional Item properties available within the controls themselves. Since a single lcListObj may be connected to multiple visible LC3 OCX controls at the same time, each control maintains its own information with regards to the visible, selected, and enabled state of each Item in the List.  This allows a single List to be viewed in seperate controls, yet each control has its own view of the list.  Each of the following controls have the ItemVisible, ItemEnabled, ItemSelected, ItemPushed, ItemBorderPushed, and ChildrenVisible properties to maintain this view-specific state information.  Note that the lcTabRas control additionally has the ItemTop, ItemLeft, ItemWidth, and ItemHeight properties.

Applies To:

lcQuick	lcTree	lcGroup	lcTabRas

TopIndex, BottomIndex, and ListIndex:

Each control has a TopIndex, BottomIndex, and ListIndex property.  These properties store some basic information about the state of a control.  The TopIndex and BottomIndex tell you the Index of first and last Items currently visible in the control display.  The ListIndex property tells the Index of the currently selected Item (if any).

Applies To:

lcQuick	lcTree	lcGroup	lcTabRas

Default Item Property Settings:

The bUseDefaults property controls the usage of the DefExpandedItem, DefCollapsedItem, DefLeafItem, DefLeafItem, and DefCurrentItem object properties.  These object properties are lcItemObj objects.  By setting the Border, Image, and Style properties within these Item objects, the control will apply these property settings to Items which do not have these properties set.

Applies To:

lcTree	lcGroup	lcTabRas

ScrollBars and Scrolling:

In most cases, the LC3 controls will regulate their own use of scrollbars and scrolling within the control.  However, in the case of the lcQuick and lcTree controls, the horizontal scrolling is set up by the programmer.  Use the HScrollMax property for this.  In all controls, drag-scrolling is available.  Drag-scrolling occurs when the User clicks and drags the mouse-pointer across the display of a control.  The control will automatically change and select the current Item as the mouse-pointer passes over that Item.  If the mouse-pointer is dragged outside the boundries of a control, the control will scroll the display to view the contents in that direction (i.e. drag outside the bottom of a control to scroll the contents of the display upwards).  The following keys may also be used to scroll the display: Home, End, PageUp, PageDown, UpArrow, LeftArrow, DownArrow, and RightArrow.

Applies To:

lcQuick	lcTree	lcGroup	lcTabRas


Optimizations

There are primarily two properties used for optimizing the speed and display of LC3 controls.  These are the DisconnectViews property and the BatchMode property.

The DisconnectViews property is a property of the lcListObj object.  When this property is set to True, all views (as LC3 OCX controls) connected to that List object will be reset and will not receive any subsequent notification of changes to the List object until the DisconnectViews property is reset to False.  At that time, all the views will be reconnected to the List object and resume their normal operation.  This technique is especially handy when a single List object is simultaneously connected to more than one view and you need to add numerous Items to that List object.  The drawback of using this property is that, when the property is reset to False, the connected views will also reinitialize all information concerning Item visibility, selection, size, etc.,.  In effect, using the DisconnectViews property is similar to setting the List object of each view to Nothing and then back to the List object storing your data.  (i.e. Set lcQuick1.List = Nothing, then Set lcQuick1.List = MyListObj).

Another, less effective, method of optimization is provided by the BatchMode property. This property is available in all of the LC3 OCXs (views).  Similar to the DisconnectViews property, the BatchMode property suspends screen updates to a particular control.  This property affects onl;y one control but does not disturb the visible state information for that view (Item visibility, selection, etc.).  Setting this property to True enables the BatchMode, thereby suspending screen updates.  Resetting it to False updates the display and resumes normal operation of the control.

Applies To:

lcQuick	lcTree	lcGroup	lcTabRas

See Also:

Control Properties


Hierarchies

The List Collection List Object (lcListObj), while primarily a List, can also be used to create a hierarchical structure.  A hierarchy in a List is determined according to each Item's Indent (lcItemObj.Indent) property value.  Root-level Items (those Items that are leftmost in the List), have an Indent value of zero.  Child Items are defined by providing them with a greater Indent value.  That is, Items with an Indent of 1 are considered to be children of the most previous Item at Indent 0.

The List Object primarily stores Item Objects according to their index (lcItemObj.ItemIndex) in the List.  In it's simplest form, a List Collection List acts just like a normal ListBox control.  This allows you to iterate through all Items in a List like this:

Dim I As Integer

For I = 0 To (List.ListCount - 1)

List.Item( I ).Text = "This is Item #" & (I + 1)

Next I

By defining hierarchies through the use of Item indentation, the hierarchical structure of a List can be modified at any time.  For example, the following code will add an Item (the parent) and then add another Item (the child) at the next Indent level:

List.AddItem "An Item", -1          ' Indent level is 0 by default

List.AddItem "Another Item", -1

List.Item( List.NewIndex ).Indent = 1  ' Set to Indent level 1

The following lines of code do the same thing but use the lcListObj.AddItemEx method (the Indent value is specified as the third parameter):

List.AddItemEx "An Item", -1, 0

List.AddItemEx "Another Item", -1, 1

See Also:

 lcItemObj :

Indent

ParentItem, ParentIndex

PrevSibItem, PrevSibIndex

NextSibItem, NextSibIndex

HasChildren

ChildCount

ChildItem

 lcListObj :

AddItemEx


Item Borders

Items have a set of properties used to allow the display of Borders and Shadows in an Item. These properties can be used once the lcItemObj.HasBorder property has been set to True. Setting this property creates the placeholder for these property values in that Item.  This saves memory for Items that don't need to display Borders.  Setting HasBorder to False will release this memory and, consequently, clear out the values for these properties.

There are several different configurable aspects of an Item's border.  The main one is BorderWidth.  This property determines the total amount of available for bevelling.  The two bevelling properties, BevelInner and BevelOuter, determine the amount and direction of bevelling to occur on the inside and the outside parts of the border.  For example, to create a typical raised border:

Item.BorderWidth = 5	' Allow room for bevelling and a thin (1 pixel) border
Item.BevelInner = 2	' Apply raised bevelling to the inside edges of the border
Item.BevelOuter = -2	' Apply lowered bevelling to the outside edges of the border

Since the ThreeD effect of the borders is highly dependent on the choice of colors used for shading, there three properties available: BorderColor, BevelLight, and BevelDark.  The BevelLight and BevelDark properties are applied where needed to produce a ThreeD effect where the light source is located in the top-left.  The BorderColor is used to fill in the rest of the BorderWidth which is left over after bevelling.  This is located in the center of the border, between the inside and outside bevelled edges.  The BorderColor is typically a standard gray, while the BevelLight and BevelDark colors are lighter and darker shades of gray, respectively.  This is typical gray border scenario:

Item.BorderColor = QBColor(7)	' Gray
Item.BevelLight = QBColor(15)	' White
Item.BevelDark = QBColor(8)	' Dark Gray

There three other factors which can be used to add a final touch to your border.  The ClientOutline and BorderOutline both provide a single black outline either inside your border (ClientOutline) or outside your border (BorderOutline).  The ShadowWidth property specifies the amount of drop shadowing that an Item's border will have.  The drop shadow is placed to the bottom-right of an Item.  Here is an enlarged border which shows the different parts of an Item's border.  The middle (BorderColor) is gray, the light color is white and the dark color is a dark gray.  This border also uses the BorderOutline and ClientOutline:

All of the visible controls in the List Collection have the ItemPushed and ItemBorderPushed properties to implement push-button effects for Items.  ItemPushed is used when an Item has a drop shadow (i.e. ShadowWidth > 0).  When set to True, the drop shadow of an Item is not displayed and the Item is offset to the bottom-right.  This would indicate a pushed state.  Setting it back to False redisplays the Item with it's shadow as unpushed.  The ItemBorderPushed property works similarly, but inverts the Item's bevelling instead.  That is, when set to True, the Item's BevelInner and BevelOuter property values are switched displaying a pushed border.  Here are some sample borders:

See Also:

 lcItemObj :

HasBorder

BorderWidth

BevelOuter

BevelInner

BorderColor

BevelLight

BevelDark

ShadowWidth

BorderOutline

ClientOutline

BorderRef


Item Images

Items have a set of properties used to allow the display of Images in an Item. These properties can be used once the lcItemObj.HasImage property has been set to True. Setting this property creates the placeholder for these property values in that Item.  This saves memory for Items that don't need to display Images.  Setting HasImage to False will release this memory and, consequently, clear out the values for these properties.

The Image property stores a standard OLE image object and can be an Icon (ICO), Bitmap (BMP), or Metafile (WMF).  There is no facility for loading images directly into an Item.  Instead, you must load images using a LoadPicture (for VB) or similar statement:

' Load an Image File from Disk into an Item
Set Item.Image = LoadPicture("C:\MyImage.BMP")

The ImageWidth, ImageHeight, and ImageZoom properties are available to shrink or stretch the Image display in an Item.  Note that the Image object has it's own Image.Width and Image.Height properties which are independent of the Item's ImageWidth and ImageHeight properties.  When an Image is initially loaded, the ImageWidth and ImageHeight properties will be set to the width and height of the loaded image.  The ImageZoom property will also be set to 1.

All of the visible controls in the List Collection have the ImagePos property to control the arrangment of the Image and Text displayed within the Item.  Here are some of the possibilities:

See Also:

 lcItemObj :

HasImage

Image

ImageWidth

ImageHeight

ImageZoom

ImageRef


Item Styles

Items have a set of properties used to control the display of text in an Item. These properties can be used once the lcItemObj.HasStyle property has been set to True. Setting this property to True creates the placeholder for these properties in an Item.  This saves memory for Items that don't need to use a custom style.  Setting HasStyle to False will release this memory and, consequently, clear out the values for these properties.

As an optimization, if the Font, ForeColor, or BackColor properties are set, the HasStyle property is automatically set to True for you.  This can't be done with the Font Object's properties, since it is itself an object.  That is, doing Item.Font.Size = 12 will give an error because there is no Font object in existence yet.  You must set the HasStyle property to True first, or set the Font property from an existing Font Object (i.e. Set Item2.Font = Item1.Font).

See Also:

 lcItemObj :

HasStyle

Font

ForeColor

BackColor

StyleRef


Constants

The following constants are defined in the Type Libraries of lcList.DLL and lcList16.DLL.  Many Automation Controllers (such as VB4) allow you to create a reference to an OLE Object's Type Library.

Mouse Constants:

lcNone =	0
lcLClick =	1
lcLDblClick =	2
lcRClick =	4
lcRDblClick =	8
lcMouseOver =	16

Applies To Properties:

SelectOn	ExpandOn	ScrollOn

Applies To Controls:

lcTree	lcGroup	lcTabRas

Image Position Constants:

lcCenter =	0
lcTop =	1
lcLeft =	2
lcBottom =	4
lcRight =	8

Applies To Properties:

ImagePos

Applies To Controls:

lcItem	lcQuick	lcTree	lcGroup	lcTabRas

Orientation Constants:

lcHorz =	1
lcVert =	2

Applies To Properties:

Orientation

Applies To Controls:

lcGroup

Hierarchy Lines Constants:

lcSolid =	1
lcDotted =	2
lcMixed =	3

Applies To Properties:

HierLineStyle

Applies To Controls:

lcQuick	lcTree


Formatted Text

Formatted Text offers a rich-text display within each Item.  Formatted text strings have codes embedded within them to alter the display of text and colors.  Each code specified in a FmtText string is delimited by a special escape character.  This escape character (you get to choose it) must appear as the first character in the string and does not get displayed to the screen.  The lcItemObj Object also has a RawText property which will return the FmtText string to you, stripped of all escape characters and codes.

Formatting Codes:

Font Formatting:

\B	Turn Bold On
\b	Turn Bold Off
\I	Turn Italic On
\i	Turn Italic Off
\U	Turn Underline On
\u	Turn Underline Off
\S	Turn Strikethru On
\s	Turn Strikethru Off
\R	Turn Transparent Font On
\r	Turn Transparent Font Off
\D	Turn ThreeD Font On
\d	Turn ThreeD Font Off
\H	Turn Shadow Font On
\h	Turn Shadow Font Off
\FD	Return to Using Default Font
Color Display:

\CFn\	Change ForeColor
\CBn\	Change BackColor
\CD	Return to Using Default Colors

The n parameter for the CF and CB codes must be a long number identifying a color value.  The return result from VB's QBColor(x) function is an acceptable value.  The 16 primary colors may also be accessed via three letter codes, and may by supplied instead of a long number:

BLK	Black
BLU	Blue
GRN	Green
CYN	Cyan
RED	Red
MAG	Magenta
YEL	Yellow (Brown)
WHT	White (Light Gray)
GRY	Gray (Dark Gray)
LTB	Light Blue
LTG	Light Green
LTC	Light Cyan
LTR	Light Red
LTM	Light Magenta
LTY	Light Yellow (Yellow)
BTW	Bright White (White)
Some of the names of these colors can be misleading.  Typically, the Yellow color will look Brownish on most systems.  The naming convention used for these color codes comes out of traditional names for these colors, not necessarily the most accurate ones.  A more accurate description of the color value (where appropriate) is indicated within the parentheses above.

Text Positioning:

\NL	NewLine - Subsequent text is displayed on the next line
\PXn\	Text pointer moved horizontally to pixel #n
\PYn\	Text pointer moved vertically to pixel #n
\CXn\	Text pointer moved horizontally to character position #n
\CYn\	Text pointer moved vertically to character position #n
\TXn\	Same as PX code (kept for compatability)
\TCn\	Same as CX code (kept for compatability)

See Also:

 lcItemObj :

FmtText

RawText


lcItemObj Object

FileName :	lcList.DLL, lcList16.DLL
ProgID :	lcListLib.lcItemObj
UUID/GUID :	87781210-8302-11CF-96DE-444553540000
lcItemObj Description:

The List Collection Item Object.

lcItemObj Properties:

Version and List Access

Property Name	Data Type	Description
Version	Single	Returns the Version of the Object
List	lcListObj	Returns the List Object an Item belongs to
ItemIndex	Long	Returns the zero-based Index of an Item in a List
Data Storage and Simple Display

Property Name	Data Type	Description
Text	String	The primary text string for each Item
LongVal	Long	A Long Value associated with each Item
StringVal	String	A String Value associated with each Item
ObjectVal	Object	An Object Value associated with each Item
TokenType	Integer	An informational property set by other Objects
TokenIndex	Long	An informational property set by other Objects
Rich-Text Display

Property Name	Data Type	Description
FmtText	String	Formatted text used for Item display
RawText	String	The FmtText property stripped of Formatting Codes
Indentation and Hierarchy Access

Property Name	Data Type	Description
Indent	Integer	Determines the Item's position in the hierarchy
ParentItem	lcItemObj	The Item's Parent Item Object
NextSibItem	lcItemObj	The Item's Next Sibling Item Object
PrevSibItem	lcItemObj	The Item's Previous Sibling Item Object
ChildCount	Long	Count of Child Items directly beneath the Item
ParentIndex	Long	Returns the Index of an Item's Parent
PrevSibIndex	Long	Returns the Index of an Item's Next Sibling
NextSibIndex	Long	Returns the Index of an Item's Previous Sibling
HasChildren	Boolean	Determine if an Item has Children Items
Border Display

Property Name	Data Type	Description
HasBorder	Boolean	Determine if Item has Border Elements
BorderWidth	Integer	Determine the Width of an Item's Border
BevelOuter	Integer	Determine amount bevelling outside the Border
BevelInner	Integer	Determine amount bevelling inside the Border
BorderColor	Long	Set the Color to draw the Border
BevelLight	Long	Set the Color to draw light bevelling
BevelDark	Long	Set the Color to draw darkened bevelling
ShadowWidth	Integer	Determine the Width of the Item's Border Shadow
BorderOutline	Boolean	Draw an Outline around the Item's Border
ClientOutline	Boolean	Draw an Outline around Image and/or Text
Font and Color Display

Property Name	Data Type	Description
HasStyle	Boolean	Determine if Item has Style Elements
Font	Object	An Item's Font Object
BackColor	Long	Set the Background Color for Item Text
ForeColor	Long	Set the Foreground Color for Item Text
HasImage	Boolean	Determine if Item has Image Elements
Image Display

Property Name	Data Type	Description
Image	Object	An Item's Image Object
ImageWidth	Long	Custom Width for Image
ImageHeight	Long	Custom Height for Image
ImageZoom	Single	Zoom factor for Image
Resource Sharing

Property Name	Data Type	Description
BorderRef	lcItemObj	Use another Item's Border
StyleRef	lcItemObj	Use another Item's Style
ImageRef	lcItemObj	Use another Item's Image
lcItemObj Methods:

Method Name	Parameters	Description
ChildItem	ChildIndex	Returns a Child Item Object for an Item
ClearData	-	Reinitialize all data for an Item
CopyData	Item	Copy all data from another Item
TextPath	-	Returns an Item's Path using the Text Field for each Item
IndexPath	-	Returns an Item's Path using the ItemIndex Field for each Item
AddChild	Text, Index	Adds a ChildItem at the specified Index
AddChildSorted	Text	Adds a Sorted ChildItem
RemoveChild	ChildIndex	Removes a Single ChildItem (and subsequent Children) from an Item
ClearChildren	-	Removes All Children from an Item


lcListObj Object

FileName :	lcList.DLL, lcList16.DLL
ProgID :	lcListLib.lcListObj
UUID/GUID :	87781220-8302-11CF-96DE-444553540000
lcListObj Description:

The List Collection List Object.

lcListObj Properties:

Property Name	Data Type	Description
ListCount	Long	Returns the number of Items currently in the List
NewIndex	Long	Returns the Index of the most recently added Item
DisconnectViews	Boolean	Suspend List Display, speeds up processing when adding many Items at once
lcListObj Methods:

List Maintenance and Item Access

Method Name	Parameters	Description
AddItem	Text, Index	Adds an Item to the List
AddItemEx	Text, Index, Indent	Adds an Item to the List at a certain Indent level
AddItemSorted	Text	Adds a New Item Sorted at Indent Level 0
RemoveItem	Index	Removes an Item from the List
RemoveTokens	TokenType	Removes All Items with a specified TokenType from the List
Clear	-	Removes All Items from the List
Item	Index	Returns an lcItemObj Object
FindItemText	Text, bMatchExact, bCaseSense, StartIndex	Finds an Item matching the specified text
List Copying

Method Name	Parameters	Description
CopyList	SrcList, SrcIndex, SrcCount, TrgIndex, TrgIndent	Copies All Items from a Source List
CopyChildren	SrcList, SrcParentIndex, TrgParentIndex, bRecurseChildren	Copies All Child Items from a Parent Item in the Source List
List Persistence

Method Name	Parameters	Description
LoadText	FileName	Loads the contents of Text File into a List
SaveText	FileName	Saves the contents of each Item.Text property to a Text File
LoadBinary	FileName	Loads the contents of Binary File into a List
SaveBinary	FileName	Saves the contents of each Item to a Binary File


Version Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	Single / Float

This property returns the current version of the component.


List Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	lcListObj Object / IDispatch

The List property returns the lcListObj Object to which the Item belongs.  This property can be used when the original lcListObj Object is not available.  Such as when an Item is passed to a subroutine wherein access to the List is required.


ItemIndex Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	Long

This property returns the index of an Item within the List.  This index is zero-based and ranges to a maximum of the List's ListCount property minus one (i.e. .ListCount - 1).


Text Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	String

The Text property is the Item's primary string storage and display property.  The Text property can be an empty (zero-length) string, or it can be any string up to 32,765 characters long.  Whatever string is placed within the Text property will be visible whenever the Item is displayed on the screen  The exception to this occurs if you are using the FmtText property.  In this case, the FmtText property will be used for display instead of the Text property.


LongVal Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long

The LongVal property is used to store an associated Long value with an Item.  This can be useful to store indexes to other lists or arrays, or counter fields from a database table.


StringVal Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	String

The StringVal property is used to store an associated String value with an Item.  This can be useful to maintain additional, hidden information related to an Item.  For example, the StringVal property may be used to store a database record's primary key value.


ObjectVal Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Object / IDispatch

The ObjectVal property is used to store an associated Object value with an Item.  This can be useful to maintain additional, hidden information related to an Item.  For example, the ObjectVal property may be used to store a referenec to another Item in a list.


TokenType Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Integer / Short

This is an informational property which is usually set by another Object.  Some Objects, when they fill up the contents of a List, may indicate the type of the Item it is adding by placing a specific value in this property.


TokenIndex Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long

This is an informational property which is usually set by another Object.  Some Objects, when they fill up the contents of a List, may specify the index of an associated Item in this property.


FmtText Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	String

The FmtText property is used to provide an Item with an alternative, formatted text display.  When this property is set with a formatted string, it overides the default display of the Text property.  A formatted string contains displayable text as well as hidden codes to control formatting.  A formatting code is indicated by the presence of an escape character.  The escape character can be any single character, and is placed at the beginning of the formatted string.

For example, the following formatted string would display the text "Hello" as bold with a red forecolor : "\\B\cfRED\Hello".  The escape character is indicated by the first character, the '\'.  The hidden codes are delimited by the escape character, '\B' turns bolding on and '\cfRED\' sets the forecolor to red.  Note that some formatting codes require a beginning and ending escape character while some only require a single escape character at the beginning.  Also note that the FmtText property gets translated internally, replacing all color specifications (i.e. RED) to a long number.

See Also:

Formatted Text


RawText Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	String

The RawText property strips the FmtText string of all hidden codes and returns just the string of displayable text.  Note that the codes which are used for positioning text (NL, PX, PY, CX, CY) translate to a single space.  For Example, the formatted string "\\B\cfRED\Hello\px20\py20\Again!" translates to the string "Hello Again!".

See Also:

Formatted Text


Indent Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Integer / Short

The Indent property determines an Item's position within the hierarchy of a List.  The default Indent value for a new Item is 0.  This places new Items all the way to the left of the display area.  The higher the Indent value of an Item, the more indented to the right the Item will be displayed within a List Control.  To make a child Item in a List, increase it's Indent value by 1.  This will cause it's other hierarchical properties (such as ParentIndex) to change.

See Also:

Hierarchies


ParentItem Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	lcItemObj Object / Idisptach

This property returns the parent Item Object of a particular Item. An Item's parent in a hierarchy is determined by that Item's lcItemObj.Indent property value.

This property will return Nothing if there is no parent for this Item. Such as, Items that have an Indent value of zero.

See Also:

Hierarchies


NextSibItem Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	lcItemObj Object / Idisptach

This property returns the next Item Object ocurring at the same Indent level of a particular Item. An Item's next sibling in a hierarchy is determined by that Item's lcItemObj.Indent property value.

This property will return Nothing if there is no next sibling for this Item. Such as, Items that have an Indent value of zero.

See Also:

Hierarchies


PrevSibItem Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	lcItemObj Object / Idisptach

This property returns the previous Item Object ocurring at the same Indent level of a particular Item. An Item's previous sibling in a hierarchy is determined by that Item's lcItemObj.Indent property value.

This property will return Nothing if there is no previous sibling for this Item. Such as, Items that have an Indent value of zero.

See Also:

Hierarchies


ChildCount Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	Long

This property returns the number of child Items that are directly underneath a particular Item.  i.e. A child of an Item has that Item as it's parent. An Item's children in a hierarchy are determined by that Item's lcItemObj.Indent property value.

This property will return zero if there are no children for this Item.

See Also:

Hierarchies


ParentIndex Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	Long

This property returns the zero-based index of the parent Item Object of a particular Item. An Item's parent in a hierarchy is determined by that Item's lcItemObj.Indent property value.

This property will return -1 if there is no parent for this Item. Such as, Items that have an Indent value of zero.

See Also:

Hierarchies


PrevSibIndex Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	Long

This property returns the zero-based Index of the previous Item Object ocurring at the same Indent level of a particular Item. An Item's previous sibling in a hierarchy is determined by that Item's lcItemObj.Indent property value.

This property will return -1 if there is no previous sibling for this Item. Such as, Items that have an Indent value of zero.

See Also:

Hierarchies


NextSibIndex Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	Long

This property returns the zero-based Index of the next Item Object ocurring at the same Indent level of a particular Item. An Item's next sibling in a hierarchy is determined by that Item's lcItemObj.Indent property value.

This property will return -1 if there is no next sibling for this Item. Such as, Items that have an Indent value of zero.

See Also:

Hierarchies


HasChildren Property

Applies To :	lcItemObj Object
Read-Write :	Read-Only
Data Type :	Boolean / Integer

This property returns True (non-zero) for an Item if the number of child Items that are directly underneath a particular Item is greater than zero.  i.e. A child of an Item has that Item as it's parent. An Item's children in a hierarchy are determined by that Item's lcItemObj.Indent property value.

This property will return False (zero) if there are no children for this Item.

Note that this property is different from the other Has... properties (HasBorder, HasImage, HasStyle).  That is, this property is used to test for the existence of child Items.  It does not pertain to the ability for an Item to have children.  All hierarchicalness (that's not a real word!) is controlled by the Item's Indent property.

See Also:

Hierarchies


HasBorder Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Boolean / Integer

This property enables and disables the Item border properties.

By setting this property to False, the Item will release some of it's memory that is dedicated to the border properties.

This property is set to False by default. Setting any of the border properties of an Item will automatically set the HasBorder property equal to True.

See Also:

Item Borders


BorderWidth Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Integer / Short

Specifies the total width of an Item's Border.  This value includes the BevelInner and BevelOuter values.  That is, these settings: (BorderWidth = 3, BevelInner = -1, BevelOuter = 1) will produce a border that is bevelled by 1 pixel on the inside and outside, and has 1 pixel of spacing in the middle.

See Also:

Item Borders


BevelOuter Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Integer / Short

Specifies the amount of bevelling (in pixels) for the outside edge of an Item's border:

Less than 0 : lowered bevelling

Equal to 0 : no bevelling

Greater than 0 : raised bevelling

The BorderWidth property determines the total amount of width of a border, while the BevelOuter and BevelInner properties determine how much of that width is bevelled, and how it is bevelled.

See Also:

Item Borders


BevelInner Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Integer / Short

Specifies the amount of bevelling (in pixels) for the inside edge of an Item's border:

Less than 0 : lowered bevelling

Equal to 0 : no bevelling

Greater than 0 : raised bevelling

The BorderWidth property determines the total amount of width of a border, while the BevelOuter and BevelInner properties determine how much of that width is bevelled, and how it is bevelled.

See Also:

Item Borders


BorderColor Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long (Color)

The color to use for the Item's Border (the space in between the border's bevelled edges, if any).

See Also:

Item Borders


BevelLight Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long (Color)

The color to use for bevelled borders.  Specifically, the Top and Left edges of raised bevelling, and the Bottom and Right edges of lowered bevelling.

See Also:

Item Borders


BevelDark Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long (Color)

The color to use for bevelled borders.  Specifically, the Top and Left edges of lowered bevelling, and the Bottom and Right edges of raised bevelling.

See Also:

Item Borders


ShadowWidth Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Integer / Short

Specifies the width (in pixels) of an Item's Shadow.  The shadow will appear to the Bottom and Right of an Item and any Border for that Item.

See Also:

Item Borders


BorderOutline Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Boolean / Integer

When True, uses a single black line (1 pixel wide) around the outside edge of an Item.  If there is a border for that Item, the line will surround the border, but be inside of any shadow for that Item.

See Also:

Item Borders


ClientOutline Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Boolean / Integer

When True, uses a single black line (1 pixel wide) around the outside edge of an Item.  If there is a border for that Item, the line will appear inside the border.

See Also:

Item Borders


HasStyle Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Boolean / Integer

This property enables and disables the Item style properties.

By setting this property to False, the Item will release some of it's memory that is dedicated to the style properties.

This property is set to False by default.

Setting the BackColor or ForeColor properties of an Item will automatically set the HasStyle property equal to True.

Since the Font property is itself an object, the HasStyle property must be set True before using it.  Setting it to True will create the "placeholder" for the Font object.

See Also:

Item Styles


Font Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Std. OLE Font Object

The Font property of an Item is itself an object containing a custom font to use for the Item's display.  The Font object has the following properties:

Name As String

Size As Currency

Bold As Boolean

Italic As Boolean

Underline As Boolean

Strikethrough As Boolean

Weight As Integer

Charset As Integer

These font properties can be used once the lcItemObj.HasStyle property has been set to True.  The Font property is of type Font.  This is a standard OLE type.

Since the Font property is itself an object, the HasStyle property must be set True before using it.  Setting it to True will create the "placeholder" for the Font object.

See Also:

Item Styles


BackColor Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long (Color)

The BackColor property is used to color the background of an Item's display.

This property is only available when the Item's HasStyle property is set to True.

See Also:

Item Styles


ForeColor Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long (Color)

The ForeColor property is used to color the text of an Item's display.

This property is only available when the Item's HasStyle property is set to True.

See Also:

Item Styles


HasImage Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Boolean / Integer

This property enables and disables the Item image properties.

By setting this property to False, the Item will release some of it's memory that is dedicated to the image properties.

This property is set to False by default.

Setting any of the image properties of an Item will automatically set the HasImage property equal to True.

See Also:

Item Images


Image Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Std. OLE Image Object

The Image property of an Item is itself an object containing a displayable Image to use for the Item's display.  The Image object has the following properties:

Handle As Integer

Height As Integer

hPal As Integer

Type As Integer

Width As Integer

These Image properties can be used once the lcItemObj.HasImage property has been set to True.  The Image property is of type Picture.  This is a standard OLE type.

Since the Image property is itself an object, the HasImage property must be set True before using it.  Setting it to True will create the "placeholder" for the Image object.

See Also:

Item Images


ImageWidth Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long

Specifies the Width of an Image in pixels.  This property can be modified to stretch the Image.

See Also:

Item Images


ImageHeight Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Long

Specifies the Height of an Image in pixels.  This property can be modified to stretch the Image.

See Also:

Item Images


ImageZoom Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	Single / Float

Specifies the Zoom factor of an Image.  This property can be modified to stretch and shrink the Image.  The default value is 1.0 (normal view).  A value of 2.0 will display the Image at twice it's normal size.  A value smaller than 1 will shrink the Image display.

The setting of this property will not modify the ImageWidth and ImageHeight properties. That is, you can change these properties and still use the ImageZoom in addition to that.

See Also:

Item Images


BorderRef Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	lcItemObj Object / IDispatch

The BorderRef property can be set to any valid Item object from any List. When set to a valid lcItemObj object, the Item it is being set to will use the border properties from the Item it is being set from.  If you have a List which will use several different borders over and over again in many different Items, a seperate List can be made to contain just those borders. The original List can use these borders, in each Item, by setting the Item's BorderRef property equal to the desired Item in the "border" List.

Note that when an Item is used as a BorderRef (i.e. another Item is using it for its border), the "border" Item will stay in memory until it is no longer needed, even if it is removed from its original list.

See Also:

Item Borders


StyleRef Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	lcItemObj Object / IDispatch

The StyleRef property can be set to any valid Item object from any List. When set to a valid lcItemObj object, the Item it is being set to will use the style properties from the Item it is being set from.  If you have a List which will use several different styles over and over again in many different Items, a seperate List can be made to contain just those styles. The original List can use these styles, in each Item, by setting the Item's StyleRef property equal to the desired Item in the "style" List.

Note that when an Item is used as a StyleRef (i.e. another Item is using it for its style), the "style" Item will stay in memory until it is no longer needed, even if it is removed from its original list.

See Also:

Item Styles


ImageRef Property

Applies To :	lcItemObj Object
Read-Write :	Yes
Data Type :	lcItemObj Object / IDispatch

The ImageRef property can be set to any valid Item object from any List. When set to a valid lcItemObj object, the Item it is being set to will use the image properties from the Item it is being set from.  If you have a List which will use several different images over and over again in many different Items, a seperate List can be made to contain just those Images. The original List can use these images, in each Item, by setting the Item's ImageRef property equal to the desired Item in the "image" List.

Note that when an Item is used as an ImageRef (i.e. another Item is using it for its image), the "image" Item will stay in memory until it is no longer needed, even if it is removed from its original list.

See Also:

Item Images


ChildItem Method

Applies To :	lcItemObj Object
Return Type :	lcItemObj Object / IDispatch
Parameter List :	( ndx As Long )

This method returns a specific child Item Object of a particular Item.

This method requires one parameter, a zero based of index of the child Item to return.  For this method, the children of Item are treated as a sublist including only the children directly beneath an Item. An Item's previous sibling in a hierarchy is determined by that Item's lcItemObj.Indent property value.

This method will return Nothing if the provided index outside the range of child Items (less-than 0, or greater-than-or-equal-to ChildCount).

Syntax:

ChildItem( ChildIndex As Long ) As lcItemObj

Parameters:

ChildIndex :	The child index of the Item to retreive

Return Value:

The child Item Object at the specified child index


ClearData Method

Applies To :	lcItemObj Object
Return Type :	none
Parameter List :	none

The ClearData method clears and reinitializes all properties of an Item. The resulting values of properties are according to thier type :

Numeric properties are set to 0.

String properties are set to an empty string "".

Object properties are set to Nothing.

Syntax:

ClearData( )

Parameters:

none

Return Value:

No return value


CopyData Method

Applies To :	lcItemObj Object
Return Type :	none
Parameter List :	( Item As lcItemObj )

The CopyData method copies data from one Item to another

Syntax:

CopyData( Item As lcItemObj )

Parameters:

Item :	The lcItemObj Object to Copy from

Return Value:

No return value


TextPath Method

Applies To :	lcItemObj Object
Return Type :	String
Parameter List :	none

The TextPath Method returns a path-like string consisting of an Item's Text value and the Text value of each Parent Item above that Item.  This method returns a string which is structured very much like a DOS pathname.

Syntax:

TextPath( PathChar As String )

Parameters:

PathChar :	The character to use for seperating Item Text values in the path string

Return Value:

The TextPath string


IndexPath Method

Applies To :	lcItemObj Object
Return Type :	String
Parameter List :	none

The IndexPath Method returns a path-like string consisting of an Item's Index value and the Index value of each Parent Item above that Item.  This method returns a string which is structured very much like a DOS pathname, but uses Index values instead of Text.

Syntax:

IndexPath( PathChar As String )

Parameters:

PathChar :	The character to use for seperating Item Index values in the path string

Return Value:

The IndexPath string


AddChild Method

Applies To :	lcItemObj Object
Return Type :	lcItemObj Object
Parameter List :	( Text As String, Index As Long )

Adds an new ChildItem to this Item's ChildList at a specified Index with the specified Text.  This method actually creates a new Item in the List.  The new Child Item will have an Indent value of one greater than this Item's Indent value.

Specifying a -1 for the Index parameter will append the new Item to the end of the ChildList.

Specifying an Index that is greater then the Item's ChildCount will also append a new Item to the end of the ChildList.

Syntax:

AddChild( Text As String, Index As Long )

Parameters:

Text :	The Text value for the new ChildItem
Index :	The Index at which to insert the new ChildItem


AddChildSorted Method

Applies To :	lcItemObj Object
Return Type :	lcItemObj Object
Parameter List :	( Text As String )

Adds a new ChildItem to this Item's ChildList. The new Child Item will have an Indent value of one greater than this Item's Indent value.  The new ChildItem is Inserted amongst this Item's children according to the value of the Text parameter passed to this method.  This Text will be compared with the Text value from each of the Item's children.  If an Item is found whose Text value is greater than the new Text value (according to the sorting order, generally digits first, then uppercase, then lowercase letters), then the new Item will be inserted immediately before that Item.  If an Item with a greater Text value is found , then the new Item is Inserted before it.  If no qualifying Item is found, then the new Item is appended to the ChildList.

Syntax:

AddChildSorted( Text As String )

Parameters:

Text :	The Text value for the new ChildItem, also determines the location on the new ChildItem


RemoveChild Method

Applies To :	lcItemObj Object
Return Type :	none
Parameter List :	( ChildIndex As Long )

Removes a ChildItem from this Item's immediate children.  Note that the ChildIndex parameter should refer to an Item's ChildIndex, not it's ListIndex.  This allows you to, say, remove the first or second ChildItem under an Item without knowledge of that ChildItem's position within the List itself.

This method will also remove all ChildItems existing underneath the removed Item.

Syntax:

RemoveChild( ChildIndex As Long )

Parameters:

ChildIndex ::	The ChildIndex of the Item to Remove


ClearChildren Method

Applies To :	lcItemObj Object
Return Type :	none
Parameter List :	none

Removes all ChildItems existing under this Item.

Syntax:

ClearChildren( )


ListCount Property

Applies To :	lcListObj Object
Read-Write :	Read-Only
Data Type :	Long

Returns the count of Items in the List.


NewIndex Property

Applies To :	lcListObj Object
Read-Write :	Read-Only
Data Type :	Long

Returns the Index of the most recently added Item to the List.


DisconnectViews Property

Applies To :	lcListObj Object
Read-Write :	Yes
Data Type :	Boolean / Integer

When set to True, all views connected to the List (i.e. all visible controls using this List) will be temporarily disconnected and will not receive notification of modifications to the List or its Items.  This very useful when populating large lists as it will greatly increase the speed of the List's operation.

Setting this property back to False will reestablish the connections between the List and any views it is connected to.

When a view is disconnected and then connected again, all property settings stored in the view on behalf of Items in the List will be cleared and set to their defaults. These properties include ItemSelected(), ItemEnabled(), ItemVisible(), ChildrenVisible(), etc.,.  This property is best used when initially populating a List or when the resetting of these other properties is not a concern.  To retain these property settings, use the BatchMode property of the view/control for a similar, yet less effective, speed increase.

See Also:

Optimizations


AddItem Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( Text As String, Index As Long )

Adds an Item to the List at a specified Index with the specified Text.  This method actually creates a new Item in the List.

Specifying a -1 for the Index parameter will append the new Item to the end of the List.

Specifying an Index that is greater then the List's current ListCount will also append a new Item to the end of the List.

Syntax:

AddItem( Text As String, Index As Long )

Parameters:

Text :	The Text value for the new Item
Index :	The Index at which to insert the new Item

Return Value:

No return value


AddItemEx Method

Applies To :	lcListObj Object
Return Type :	lcItemObj Object
Parameter List :	( Text As String, Index As Long, Indent As Integer )

Adds an Item to the List at a specified Index and Indent level with the specified Text.  This method actually creates a new Item in the List.

Specifying a -1 for the Index parameter will append the new Item to the end of the List.

Specifying an Index that is greater then the List's current ListCount will also append a new Item to the end of the List.

Syntax:

AddItemEx( Text As String, Index As Long, Indent As Integer )

Parameters:

Text :	The Text value for the new Item
Index :	The Index at which to insert the new Item
Indent :	The Indent value for the new Item

Return Value:

Returns the new Item Object that was just added


AddItemSorted Method

Applies To :	lcListObj Object
Return Type :	lcItemObj Object
Parameter List :	( Text As String )

Adds an Item to the List at Indent Level 0.  The Item is Inserted into the List according to the value of the Text parameter passed to this method.  This Text will be compared with the Text value from each Item object occuring at Indent Level 0.  If an Item is found whose Text value is greater than the new Text value (according to the sorting order, generally digits first, then uppercase, then lowercase letters), then the new Item will be inserted immediately before that Item.  If an Item with a greater Text value is found , then the new Item is Inserted before it.  If no qualifying Item is found, then the new Item is appended to the List.

Syntax:

AddItemSorted( Text As String )

Parameters:

Text :	The Text value for the new Item, also used to determine the location of the new Item

Return Value:

Returns the new Item Object that was just added


RemoveItem Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( Index As Long )

Removes a single Item (specified by the Index parameter) from the List.

Syntax:

RemoveItem( Index As Long )

Parameters:

Index :	The Index of the Item to Remove

Return Value:

No return value


RemoveTokens Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( TokenType As Integer )

Removes a all Items in the List whose TokenType property is equal to the TokenType parameter for this method.  The method provides convenient way to mark and remove many Items at once.

Syntax:

RemoveTokens( TokenType As Integer )

Parameters:

TokenType :	The TokenType of Items to Remove

Return Value:

No return value


Clear Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	none

Clears/removes all Items from the List.

Syntax:

Clear( )

Parameters:

none

Return Value:

No return value


Item Method

Applies To :	lcListObj Object
Return Type :	lcItemObj Object
Parameter List :	( Index As Long )

Returns the Item Object at the specified Index.  This method returns Items from the underlying List of the control.

Syntax:

Item( Index As Long ) As lcItemObj

Parameters:

Index :	The Index of the Item to retreive

Return Value:

The Item Object at the specified Index


FindItemText Method

Applies To :	lcListObj Object
Return Type :	lcItemObj Object
Parameter List :	( Text As String, bMatchExact As Boolean, bCaseSense As Boolean, StartIndex As Long )

Searches for the specified text within the List.  Returns the first Item found whose Text property matches the text passed to this method.  Searching parameters can be modified to perform case sensitive searches, exact matches, and where in the List to begin searching.

Syntax:

FindItemText( Text As String, bMatchExact As Boolean, bCaseSense As Boolean, StartIndex As Long) As lcItemObj

Parameters:

Text :	The Text to search for
bMatchExact :	If True, the search must find an Item's Text which exactly matches the text parameter passed.  If False, a match will result if the text matches the first part of an Item's Text
bCaseSense :	Use case sensitivity while matching
StartIndex :	The Index of the first Item to begin searching.

Return Value:

The Item Object whose Text matches the text parameter passed to this method, or Nothing if no match was found.


CopyList Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( SrcList As lcListObj, SrcIndex As Long, SrcCount As Long, TrgIndex As Long, TrgIndent As Integer )

This method copies Items from one List (the SrcList) into this List.  The copying process begins at SrcIndex in SrcList and copies for SrcCount Items.  Each copied Item is inserted into the List beginning at the specified TrgIndex and TrgIndent.

The results of this method inserts new copies of Items (as opposed to maintaining a reference to an Item as in the ImageRef property) into the List.  This means that subsequent changes to one Item will not be reflected by copies of that Item existing within other Lists.

Syntax:

CopyList( SrcList As lcListObj, SrcIndex As Long, SrcCount As Long, TrgIndex As Long, TrgIndent As Long )

Parameters:

SrcList :	The List object to Copy Items From
SrcIndex :	The Index of the First Item to Copy
SrcCount :	The Count of Items to Copy
TrgIndex :	The Index at which to begin Copying Items
TrgIndent :	The Indent level at which to begin Copying Items

Return Value:

No return value


CopyChildren Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( SrcList As lcListObj, SrcParentIndex As Long, TrgParentIndex As Long, bRecurseChildren As Boolean )

This method copies Child Items from one List (the SrcList) into this List.  The copying process begins with the Children of the Item at SrcParentIndex in SrcList.  Each copied Item is inserted into the List as a Child of the Item at TrgParentIndex.  This copy process can be recursive (i.e. copy children of children) if the bRecurseChildren parameter is set to True.

The results of this method inserts new copies of Items (as opposed to maintaining a reference to an Item as in the ImageRef property) into the List.  This means that subsequent changes to one Item will not be reflected by copies of that Item existing within other Lists.

Syntax:

CopyChildren( SrcList As lcListObj, SrcParentIndex As Long, TrgParentIndex As Long, bRecurseChildren As Boolean )

Parameters:

SrcList :	The List object to Copy Items From
SrcParentIndex :	The Index of the Parent Item from which to Copy From
TrgParentIndex :	The Index of the Parent Item from which to Copy To
bRecurseChildren	Specify whether to copy children of children

Return Value:

No return value


LoadText Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( FileName As String )

This method will Load the contents of a Text File into the List, creating new Items for each line of text found in the file.  This file (specified by the sFileName parameter) must be a text file wherein each line of text is terminated by a carraige-return line-feed pair. The results of this method will build a new List with the Text property of each Item containing each line of text found in the file.

Syntax:

LoadText( FileName As String )

Parameters:

FileName :	The FileName used for storage

Return Value:

No return value


SaveText Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( FileName As String )

This method will store the value of the Text property for Item in the List into a Text File (specified by the sFileName parameter).  The contents of this file will represent each Text property value as a line of text in a text file (each line of text is terminated by a carraige-return line-feed pair).

Syntax:

SaveText( FileName As String )

Parameters:

FileName :	The FileName used for storage

Return Value:

No return value


LoadBinary Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( FileName As String )

This method will Load the contents of a Binary File into the List, building a new List of Items reflecting the contents of that file.  This file should be a file that was created using the SaveBinary method.  Note that the following Item properties will not be restored by using this method: ObjectVal, ImageRef, BorderRef, and StyleRef.

Syntax:

LoadBinary( FileName As String )

Parameters:

FileName :	The FileName used for storage

Return Value:

No return value


SaveBinary Method

Applies To :	lcListObj Object
Return Type :	none
Parameter List :	( FileName As String )

This method will store the contents of a List to a Binary File (specified by the sFileName parameter).  The contents of this file will contain the property values for each property in each Item within the List.  Note that the following Item properties will not be saved by using this method: ObjectVal, ImageRef, BorderRef, and StyleRef.

Syntax:

SaveBinary( FileName As String )

Parameters:

FileName :	The FileName used for storage

Return Value:

No return value


Control Properties

This topic lists all of the properties for the main List Collection List controls.

List and Item Access

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
List	X	X	X	X	Returns the List Object used for display
Item( )	X	X	X	X	Returns an Item Object from the List

Scrolling and Mousing

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
HScrollVisible	X	X	X	X	Horizontal ScrollBar visibility
VScrollVisible	X	X	X	X	Vertical ScrollBar visibility
HScrollMax	X	X	-	-	Horizontal scroll width
HSmallScroll	-	-	-	X	Minimum horizontal scroll value
VSmallScroll	-	-	-	X	Minimum vertical scroll value
SelectOn	-	X	X	X	Determine which mouse actions will select Items
ExpandOn	-	X	X	X	Determine which mouse actions will expand Items
ScrollOn	-	X	X	X	Determine which mouse actions will scroll the List display

Item Defaults

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
UseDefaults	-	X	X	X	Use the Def…Item properties for default Item display
DefExpandedItem	-	X	X	X	Default settings for expanded parent Items
DefCollapsedItem	-	X	X	X	Default settings for collapsed parent Items
DefLeafItem	-	X	X	X	Default settings for child Items
DefSelectedItem	-	X	X	X	Default settings for selected Items
DefCurrentItem	-	X	X	X	Default settings for the current Item

Item Layout

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
ImagePos	X	X	X	X	Display images to top, left, right, or bottom of text
ItemWidth	-	-	X	-	Width (in pixels) of all Items in List
ItemHeight	X	X	X	-	Height (in pixels) of all Items in List
ItemSpacing	X	X	X	-	Amount of spacing (in pixels) between Items
IndentWidth	X	X	-	-	Number of pixels to indent child Items at each indent level

Item View State

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
ItemVisible( )	X	X	X	X	Make Item visible/invisible
ItemEnabled( )	X	X	X	X	Make Item enabled/disabled
ItemSelected( )	X	X	X	X	Make Item selected/unselected
ItemPushed( )	X	X	X	X	Make Item look pushed when using an Item shadow
ItemBorderPushed( )	X	X	X	X	Inverts Item's border bevelling
ChildrenVisible( )	X	X	X	X	Make Item's children visible/invisible

Group Layout

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
ShowParent	-	-	X	-	Show the current parent Item (for upwards navigation)
Orientation	-	-	X	-	Horizontal or vertical layout of Items
ItemWrap	-	-	X	-	Wraps Items to fit in display area

TabRas Layout

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
ItemCalcWidth( )	-	-	-	X	Calculated width for Item
ItemCalcHeight( )	-	-	-	X	Calculated height for Item
ItemTop( )	-	-	-	X	Top (y) for Item's position
ItemLeft( )	-	-	-	X	Left (x) for Item's position
ItemWidth( )	-	-	-	X	Width for Item (0 to ue CalcWidth)
ItemHeight( )	-	-	-	X	Height for Item (0 to ue CalcHeight)

Hierarchy Decorations

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
HasHierLines	X	X	-	-	Toggle hierarchy lines on/off
HasHierPlusMinus	X	X	-	-	Toggle hierarchy plus and minus signs on/off
HierLineStyle	X	X	-	-	Change hierarchy line style (solid, dotted, or mixed)
HierLineColor	X	X	-	-	Hierarchy line color

Run-Time List Properties

	Applies To Controls:
Property Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
BatchMode	X	X	X	X	Temporarily suspend screen display to increase speed
ListIndex	X	X	X	X	Index of currently selected Item
TopIndex	X	X	X	-	Index of the Item currently at the top of the display area
BottomIndex	X	X	X	-	Index of the Item currently at the bottom of the display area
ExpandLevel	X	X	-	-	Automatically expand all Items up to a specific indent level
CurrParentIndex	-	X	-	-	Index of parent Item whose children are currently visible

See Also:

Control Properties


Control Events

	Applies To Controls:
Event  Name	lcQuick	lcTree	lcGroup	lcTabRas	Description
BatchMode	X	X	X	X	Temporarily suspend screen display to increase speed
ListIndex	X	X	X	X	Index of currently selected Item
TopIndex	X	X	X	-	Index of the Item currently at the top of the display area
BottomIndex	X	X	X	-	Index of the Item currently at the bottom of the display area
ExpandLevel	X	X	-	-	Automatically expand all Items up to a specific indent level
CurrParentIndex	-	X	-	-	Index of parent Item whose children are currently visible


 lcQuick Control

FileName :	lcQuick.OCX, lcQuic16.OCX
ProgID :	lcQuickLib.lcQuick
UUID/GUID :	87781A10-8302-11CF-96DE-444553540000

The List Collection Quick Tree Control.  This control is extremely similar to the lcTree control in functionality, but does not have some of the advanced properties such as the default Item properties.

lcQuick Description:

The lcQuick Control displays a List as hierarchical structure in a Tree format with expandable and collapsable parent nodes-Items.  Child Items are displayed underneath and indented to the right of Parent Items.  The amount of indentation used is determined by the IndentWidth property.  Child Items may be visually connected to Parent Items with the HasHierLines, HierLineStyle, and HierLineColor properties.  Additionally, using the HasHierPlusMinus property will display a small plus-minus symbol to the left of Parent Items.  Users can click the plus-minus symbol to automatically expand and collapse that Parent Item.  A collapsed Parent will show a minus symbol, expanded Parents show a minus.  This provides a convenient way for users to browse the hierarchy without disturbing their current selection.

Items size for all Items in the List is determined by the ItemHeight property.  The width of each Item is determined automatically by the control and displayed accordingly.

See Also:

Control Properties


 lcTree Control

FileName :	lcTree.OCX, lcTree16.OCX
ProgID :	lcTreeLib.lcTree
UUID/GUID :	87781A50-8302-11CF-96DE-444553540000

The List Collection Tree Control.  Displays Lists in a vertical, outline format.  This control also provides special hierarchy features such as expand and collapse of parent Items.

lcTree Description:

The lcTree Control displays a List as hierarchical structure in a Tree format with expandable and collapsable parent nodes-Items.  Child Items are displayed underneath and indented to the right of Parent Items.  The amount of indentation used is determined by the IndentWidth property.  Child Items may be visually connected to Parent Items with the HasHierLines, HierLineStyle, and HierLineColor properties.  Additionally, using the HasHierPlusMinus property will display a small plus-minus symbol to the left of Parent Items.  Users can click the plus-minus symbol to automatically expand and collapse that Parent Item.  A collapsed Parent will show a minus symbol, expanded Parents show a minus.  This provides a convenient way for users to browse the hierarchy without disturbing their current selection.

Items size for all Items in the List is determined by the ItemHeight property.  The width of each Item is determined automatically by the control and displayed accordingly.

The UseDefaults property controls the usage of the DefExpandedItem, DefCollapsedItem, DefLeafItem, DefLeafItem, and DefCurrentItem object properties.  These object properties are lcItemObj objects.  By setting the Border, Image, and Style properties within these Item objects, the control will apply these property settings to Items which do not have these properties set.

See Also:

Control Properties


 lcGroup Control

FileName :	lcGroup.OCX, lcGrou16.OCX
ProgID :	lcGroupLib.lcGroup
UUID/GUID :	87781A30-8302-11CF-96DE-444553540000

The List Collection Group Control.  This control displays a child-list of Items at a single time and provides the ability adjust the layout of Items either horizontally or vertically.

lcGroup Description:

The lcGroup Control displays a List as hierarchical structure in a Group format with expandable and collapsable parent nodes-Items.  When Parent Items are expanded, the current display is cleared and reset with the Child Items of the expanded Parent.  The expanded Parent Item may or may not be displayed in the Child List depending on the ShowParent property.  If the expanded Parent is displayed, the User can double-click it to collapse that Parent Item.  This will cause the control to move up one level in the hierarchy and re-display the previous List of Child Items (of which the collapsed Parent Item is a member).

Items size for all Items in the List is determined by the Item Width and ItemHeight property.  Displayed Items in the List are automatically arranged either horizontally or vertically (Orientation property). The control may also automatically wrap Items to the size of the display through the use of the ItemWrap property.

The UseDefaults property controls the usage of the DefExpandedItem, DefCollapsedItem, DefLeafItem, DefLeafItem, and DefCurrentItem object properties.  These object properties are lcItemObj objects.  By setting the Border, Image, and Style properties within these Item objects, the control will apply these property settings to Items which do not have these properties set.

See Also:

Control Properties


 lcTabRas Control

FileName :	lcTabRas.OCX, lcTabR16.OCX
ProgID :	lcTabRasLib.lcTabRas
UUID/GUID :	87781A40-8302-11CF-96DE-444553540000

The List Collection TabRas Control.  The lcTabRas Control displays a List as hierarchical structure in an programmer-defined format.  Each Item has its own Top, Left, Width, and Height properties.

lcTabRas Description:

Items size and arrangement is completely determined by the programmer and is controlled through the use of the ItemTop(), ItemLeft(), ItemWidth(), and ItemHeight() properties.  The ItemCalcWidth() and ItemCalcHeight() read-only properties tell you the unconstrained dimensions of an Item.

The UseDefaults property controls the usage of the DefExpandedItem, DefCollapsedItem, DefLeafItem, DefLeafItem, and DefCurrentItem object properties.  These object properties are lcItemObj objects.  By setting the Border, Image, and Style properties within these Item objects, the control will apply these property settings to Items which do not have these properties set.

See Also:

Control Properties


 lcFilerObj Object

FileName :	lcFiler.DLL, lcFile16.DLL
ProgID :	lcFilerLib.lcFilerObj
UUID/GUID :	87781930-8302-11CF-96DE-444553540000
Property Name	Data Type	Description
List	lcListObj	The List Used by Filer Properties and Methods
LogPath	String	Log the Contents of a Pathname (w/wildcards) into the List Object
LogDirs	Boolean	Enable/Disable Logging Directories
LogFiles	Boolean	Enable/Disable Logging Files
LogAttrReadOnly	Boolean	Enable/Disable Logging ReadOnly Files
LogAttrArchive	Boolean	Enable/Disable Logging Archived Files
LogAttrSystem	Boolean	Enable/Disable Logging System Files
LogAttrHidden	Boolean	Enable/Disable Logging Hidden Files
FileName	String	FileName (including path) to Parse
FilePath	String	Parsed FileName Path
FileTitle	String	Parsed FileName Title - No Path, No Extension
FileExt	String	Parsed FileName Extension


 lcParseObj Object

FileName :	lcParse.DLL, lcPars16.DLL
ProgID :	lcParseLib.lcParseObj
UUID/GUID :	87781910-8302-11CF-96DE-444553540000
Property Name	Data Type	Description
ParseString	String	The string used for Parsing
Whitespace	String	The string of whitespace (ignored) chars
Keywords	lcListObj	The List Object containing Keywords to be parsed out
Symbols	lcListObj	The List Object containing Symbols to be parsed out
Tokens	lcListObj	The List Object containing the resulting parsed Tokens
bCaseSensitive	Boolean	Toggle Case sensitivity for matching symbols, keywords and keywords
bCaseEnforce	Boolean	Replaces keywords found in ParseString with the exact text in the keyword
bDoubleQuotes	Boolean	Auto-detect double-quoted string literals as a single token
bSingleQuotes	Boolean	Auto-detect single-quoted string literals as a single token
bDetectInteger	Boolean	Auto-detect whole integers as a single token
bDetectReal	Boolean	Auto-detect real numbers (i.e.: 3.14) as a single token


ParseString Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	String

Using the ParseString Property and the Parsed String List allow you to easily identify and manipulate portions of strings.  By cutting a string up into tokens, you can search for an individual token, modify it, and retrieve the modification within the rebuilt ParseString.

The ParseString Property is, after setting up the Parser, one of the main points of interaction between your program and the Parse object.  The setup is accomplished by adding WhiteSpace Characters, Symbols, and Keywords, and then setting the various "b" Flags. In order to parse tokens out of a string, assign that string to the ParseString Property.  The Parser will begin searching and identifying tokens (text delimited by whitespace and symbols), and adding them to the Tokens List.

After the string has been parsed, LParse will recreate the ParseString by recombining the items in the Tokens List.  This occurs every time you ask for the value of the ParseString Property.  Therefore, any changes made to the Items in the Tokens List will be reflected the next time you get the value of the ParseString.


Whitespace Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	String

This Property along with the Symbols List, provides for the primary function of the Parse Object.  That is, Identifying Tokens within the ParseString and listing them as individual Items in the Tokens List.  Typically, the Whitespace property would contain at least some of the following characters : space, tab, carraige- return, and linefeed.

The Whitespace Property is a string containing characters which are used, during the Parsing Operation, to Identify and delimit Tokens found in the ParseString Property.  Whitespace refers to characters which serve no real purpose other than to separate words or tokens.  Whitespace characters are similar to Symbols in that they are both used to determine the end of a particular token;  However, they differ in that symbols may contain more than one character.  The Parser also treats whitespace a little differently than Symbols when copying it to the Parsed String List.  If a series of whitespace characters are found together within the ParseString, such as three spaces in a row, all the characters will be copied to the Parsed String List as a single Item. In the case of Symbols, each Symbol encountered is copied are added to the list as separate items.


Keywords Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	lcListObj Object

The Keywords List is a full-featured List object.  As Such, you can manipulate it's contents by using AddItem, Clear, etc.

The Keywords List provides the Parser with a list of words (delimited by a symbol or whitespace) to be identified in the ParseString.


Symbols Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	lcListObj Object

The Symbols List is a full-featured List object.  As Such, you can manipulate it's contents by using AddItem, Clear, etc.

A symbol can be more than one character, but is usually limited to a single character such as a backslash or a comma.


Tokens Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	lcListObj Object

The Tokens List is a full-featured List object.  As Such, you can manipulate it's contents by using AddItem, Clear, etc.

The Tokens List is built as result of the parsing process (i.e. when the ParseString property is set).  It will contain each token that was parsed-out as a seperate item in the list.  These Tokens can be modified or deleted to alter the contents of the ParseString Property.


bCaseSensitive Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	Boolean

The bCaseSensitive Property can be True or False.  This value controls whether any Symbols or Keywords found in the ParseString are identified with matching case (or regardless of case).

This property is used when you need to identify Symbols and Keywords that are case sensitive.


bCaseEnforce Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	Boolean

The bCaseEnforce Property can be True or False.  This value controls whether the Parser will enforce the case of parsed Symbols and Keywords when rebuilding the ParseString.

This property is only useful when the bCaseSensitive Property is False.  When the Parser parses the ParseString and finds a text Symbol or Keyword, having the bCaseEnforce Property set to True will cause the the Parser to store the token as it appears in the Symbols or Keywords List.


bDoubleQuotes Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	Boolean

This property is useful when you need to extract quoted, literal strings from within another string.

The bDoubleQuotes Property can be True or False.  This value controls whether the Parser will automatically detect double quoted strings.  If this value is True and a double quote character is encountered in the ParseString, the Parser will get everything up to the next double quote character (or the end of string) and treat that as a single token in the Tokens List.


bSingleQuotes Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	Boolean

This property is useful when you need to extract quoted, literal strings from within another string.

The bSingleQuotes Property can be True or False. This value controls whether the Parser will automatically detect single quoted strings. If this value is True and a single quote character is encountered in the ParseString, the Parser will get everything up to the next single quote character (or the end of string) and treat that as a single token in the Tokens List.


bDetectInteger Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	Boolean

This property is useful for finding embedded numerics in your ParseString.  The bDetectInteger Property can be True or False.  This value allows the Parser to automatically detect numerics (delimited by whitespace and symbols) within the ParseString.  When this value is True and LParse finds a digit as the first character of a token, all consecutive digits will be parsed out as a single token and placed in the Tokens List.  This property is similar to, yet differs from, the bDetectReal Property.  That is, the bDetectReal Property will read past a decimal point where the bDetectInteger Property will not.


bDetectReal Property

Applies To :	lcParseObj Object
Read-Write :	Yes
Data Type :	Boolean

This property is useful for finding embedded numerics in your ParseString.  The bDetectReal Property can be True or False.  This value allows the Parser to automatically detect numerics (delimited by whitespace and symbols) within the ParseString.  When this value is True and LParse finds a digit (or a decimal followed by a digit) as the first character of a token, all consecutive digits will be parsed out as a single token and placed in the Parsed String List. This property is similar to, yet differs from, the bDetectInteger Property.  That is, the bDetectReal Property will read past a decimal point where the bDetectInteger Property will not.


 lcItem Control

FileName :	lcItem.OCX, lcItem16.OCX
ProgID :	lcItemLib.lcItem
UUID/GUID :	87781A20-8302-11CF-96DE-444553540000

lcItem Description:

The List Collection Item Control.  The lcItem control displays a single lcItemObj object.  In this respect, this control differs from the rest of the LC3 controls.  the Item object property allows you access to Item properties.

lcItem Properties:

Property Name	Data Type	Description
Item	lcItemObj	Returns the Item Object used for display
ImagePos	Integer	Display images to top, left, right, or bottom of text
ItemPushed	Boolean	Make Item look pushed when using an Item shadow
ItemBorderPushed	Boolean	Inverts Item's border bevelling


 lcPPG Control

FileName :	lcPPG.OCX, lcPPG16.OCX
ProgID :	lcPPGLib.lcPPG
UUID/GUID :	87781310-8302-11CF-96DE-444553540000
Property Name	Data Type	Description
ShowDataPPG	Boolean	Shows the Item's Data Property Page
ShowBorderPPG	Boolean	Shows the Item's Border Property Page
ShowStylePPG	Boolean	Shows the Item's Style Property Page
ShowImagePPG	Boolean	Shows the Item's Image Property Page
ItemPPGCaption	String	Caption to Display at Top of Property Page Window
Method Name	Parameters	Description
DoItemPPG	Item, hWnd	Displays the Selected Property Pages for a Given Item


ShowDataPPG Property

Applies To :	lcPPG Control
Read-Write :	Yes
Data Type :	Boolean

Displays the Property Page used to edit the Data properties of an Item.  The properties are:

Text

FmtText

LongVal

StringVal

TokenType

TokenIndex

See Also:

DoItemPPG Method


ShowBorderPPG Property

Applies To :	lcPPG Control
Read-Write :	Yes
Data Type :	Boolean

Displays the Property Page used to edit the Border properties of an Item.  The properties are:

HasBorder

BorderWidth

BevelInner

BevelOuter

BorderColor

BevelLight

BevelDark

ClientOutline

BorderOutline

See Also:

DoItemPPG Method


ShowStylePPG Property

Applies To :	lcPPG Control
Read-Write :	Yes
Data Type :	Boolean

Displays the Property Page used to edit the Style properties of an Item.  The properties are:

HasStyle

Font

ForeColor

BackColor

See Also:

DoItemPPG Method


ShowImagePPG Property

Applies To :	lcPPG Control
Read-Write :	Yes
Data Type :	Boolean

Displays the Property Page used to edit the Image properties of an Item.  The properties are:

HasImage

Image

ImageWidth

ImageHeight

ImageZoom

See Also:

DoItemPPG Method


ItemPPGCaption Property

Applies To :	lcPPG Control
Read-Write :	Yes
Data Type :	String

This property lets you set the caption visible at the top of the Property Page Window.

See Also:

DoItemPPG Method


DoItemPPG Method

Applies To :	lcPPG Control
Return Type :	none
Parameter List :	( Item As lcItemObj, hWnd As Long )

This method actually displays the property page dialog for a specific Item.  One or more property pages may be activated for display by using the Show---PPG properties for this control.  Each of these property pages contains suitable edit fields for Item properties in each of the four following groups:

Group	Activate Using	Displays/Edits Item Properties
Data:	ShowDataPPG	Text
		FmtText
		LongVal
		StringVal
		TokenType
		TokenIndex
Border:	ShowBorderPPG	HasBorder
		BorderWidth
		BevelInner
		BevelOuter
		BorderColor
		BevelLight
		BevelDark
		ClientOutline
		BorderOutline
Style:	ShowStylePPG	HasStyle
		Font
		ForeColor
		BackColor
Image:	ShowImagePPG	HasImage
		Image
		ImageWidth
		ImageHeight
		ImageZoom

The Item Object, passed as the first parameter to this method, gets displayed and possibly modified by the user at run-time via the property pages.

Syntax:

DoItemPPG( Item As lcItemObj, hWnd As Long )

Parameters:

Item :	lcItemObj Object to Edit in the Property Pages
hWnd :	Window Handle of Owner Window for Property Page Dialog

Return Value:

No return value